Entrar

Precisa usar a API servidor-para-servidor do TikTok para rastrear conversões? Nós te ajudamos.

Adicionamos Cenários Personalizados ao FunnelFlux Pro para cobrir isso.

Aqui está o que você precisa:

  1. Uma conta no TikTok, obviamente
  2. Um pixel e seu ID -- e você deve ser o proprietário do pixel
  3. Alguns minutos de tempo livre

Prefácio - Criando Pixels e Preparando Eventos

Muitos usuários têm perguntado sobre isso, e o TikTok atualizou recentemente sua interface de criação de pixels.

Observe que o TikTok frequentemente muda sua interface, então algumas das instruções abaixo podem ficar desatualizadas (mas ainda devem ser razoavelmente fáceis de seguir).


Criando um pixel

  1. Vá para Ativos > Eventos, então escolha gerenciar eventos da web.
  2. Clique em gerenciar eventos da web > criar um pixel usando o modo API de Eventos
  3. Selecione configurar manualmente a API de eventos. Então clique no botão "Ir para configurações" para completar a configuração

Testando e preparando eventos da web

Se você tem um pixel baseado na web (não a escolha de API de eventos, mas sim o Pixel TikTok), você pode usar a página abaixo para enviar eventos fictícios para mostrar que está funcionando e criar atividade recente:

https://test-resources.funnelflux.pro/tiktok/pixel-test.html?pixel=XXX

Substitua o XXX pelo ID do seu pixel e carregue esta página. A página deve mostrar o ID que foi carregado, e você tem vários botões que acionarão eventos do TikTok.

  1. Se você quiser verificar um pixel padrão, pode usar a URL acima com o ID do seu pixel incluído como URL de verificação. Deve verificar corretamente usando isso (se eles ainda tiverem esse recurso)
  2. Se você clicar no seu pixel na interface do TikTok > guia de eventos de teste, pode usar esta URL para gerar um código QR e testar no seu dispositivo móvel. Clique nos vários botões e você deverá ver os eventos de teste aparecerem
  3. Carregue esta URL no seu navegador normalmente e clique em cada botão 3-5 vezes para enviar alguns eventos. Espere alguns minutos e atualize as configurações do pixel no TikTok, e você deverá ver seus eventos lá.

Depois de fazer o item #3 acima, todos esses eventos devem aparecer como ativos para o pixel.


Configurando a API de Eventos para Rastreamento de Conversão

Não está claro na documentação do TikTok, mas se você não for o proprietário/administrador do pixel (por exemplo, você apenas recebeu acesso compartilhado), então seu token de acesso não terá permissão para enviar eventos de conversão para esse pixel via API.

Se um pixel foi compartilhado com você, você precisará pedir ao proprietário para realizar a ação abaixo e então fornecer a você o token de acesso produzido.

Passo 1 - Gerar um Token de Acesso

Primeiro, você precisará gerar um token de acesso que permita que nosso aplicativo de API de conversão do TikTok acesse sua conta e seus pixels.

Para fazer isso, vá para o seu pixel de API de eventos > configurações. Role para baixo e você deverá ver uma área como esta:

Isso gerará um token de acesso a nível de pixel, que só funcionará para este pixel. Tenha isso em mente, pois se você tentar usá-lo para outros pixels, não funcionará.

Copie esse valor e use-o nas configurações de cenário personalizado no FunnelFlux (para a fonte de tráfego TikTok > aba de rastreamento de conversão)

Passo 2 - Configurar o TikTok como Fonte de Tráfego no FunnelFlux

No FunnelFlux, vá para a página de fontes de tráfego e crie uma nova.

Comece a digitar Tik... no nome e selecione o modelo TikTok.

Isso preencherá a seção de campos de rastreamento assim:

Aqui, o campo que precisamos criticamente é o external, que funcionará bem e está atualmente configurado para capturar o parâmetro ttclid (que tem o token __CLICKID__).

Agora vá para a aba de rastreamento de conversão, escolha Cenário Personalizado > TikTok:

Aqui você precisa:

  • Colar seu token de acesso que você gerou anteriormente. Certifique-se de que ele não tenha espaços em branco extras antes/depois
  • Colocar seu ID de pixel, que você pode obter na interface do TikTok
  • Escolher um dos nomes de eventos padrão

No momento, você só pode enviar um único nome de evento para a fonte de tráfego. No entanto, você pode escolher a opção "Personalizado – Valor da ID de Transação" e então em suas conversões/postbacks, enviar tx=nomeDoEvento. Então esse nomeDoEvento seria passado de volta para o TikTok como o nome do evento padrão. Uma solução útil se você quiser usar IDs de transação para enviar diferentes tipos de eventos.

Os eventos padrão do TikTok estão documentados aqui (use o sumário no lado direito). Estes são os eventos disponíveis no momento da escrita:

ViewContent
ClickButton
Search
AddToWishlist
AddToCart
InitiateCheckout
AddPaymentInfo
CompletePayment
PlaceAnOrder
Contact
Download
SubmitForm
CompleteRegistration
Subscribe

Nós automaticamente passamos o valor de receita da sua conversão e um valor de moeda em USD.

E é isso! Agora você deve rastrear eventos do TikTok via S2S.


Atualizações Planejadas

Passagem de Dados

Planejamos passar automaticamente o seguinte também, em uma atualização posterior. Faremos algo similar com nosso cenário de rastreamento de conversão do FB.

  • content_type - categoria da oferta que converteu
  • content_id - ID FunnelFlux da página de oferta que converteu
  • description - nome da oferta que converteu

Substituições de URL de Página

Estamos cientes de que enviar a URL da oferta nem sempre é ideal, especialmente para fontes como o Facebook onde a verificação de domínio é necessária.

Estamos trabalhando em um recurso de substituição de URL de página que permitirá passar uma URL para sua oferta/rede, e então enviar isso de volta em qualquer rastreamento de conversão para informar nosso sistema para usar uma URL diferente da URL da oferta.

Nosso objetivo aqui é permitir que você passe a URL da página inicial em que o usuário pousou -- não necessariamente uma landing page, mas apenas a primeira página do clique no anúncio -- porque esta tem a maior chance de ser uma página sob seu controle.

Infelizmente, não podemos simplesmente adicionar um novo token a postbacks/cenários personalizados como {primeira-pagina-visitada} porque não é prático consultar uma única linha em nosso banco de dados de análise para cada conversão, para procurar um valor relacionado. Mas, temos uma solução em mente!

Eventos Personalizados

Quando adicionarmos eventos personalizados ao nosso sistema, permitiríamos que você definisse diferentes nomes de eventos para enviar ao TikTok para cada um desses eventos. Por exemplo, evento personalizado 1 (alias lead) --> enviar nome do evento CompleteRegistration, etc.